Skip to content

docs: synchronize Docusaurus documentation with SDK implementation#185

Closed
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/docusaurus-documentation-synchronization-d2ff
Closed

docs: synchronize Docusaurus documentation with SDK implementation#185
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/docusaurus-documentation-synchronization-d2ff

Conversation

@cursor

@cursor cursor Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Clarify Scan API auth behavior, including API key and bearer-token combinations supported by init() and ApiKeyAuth.
  • Correct Red Team examples for enum casing and updatePrompt payload shape.
  • Align developer architecture/vocabulary docs with current request specs, pagination models, and read-only Model Security rules.
  • Add a runnable examples MDX page and include it in the Docusaurus sidebar.
  • Document OAuth token endpoint defaults and regional endpoint overrides more accurately.

Validation

  • npm run docs:build (passed; TypeDoc emitted the existing unresolved-link warning for DashboardAppQuery.appId)
  • npx prettier --check docs-site/docs/developer/architecture.md docs-site/docs/developer/vocabulary.md docs-site/docs/getting-started/configuration.mdx docs-site/docs/getting-started/environment-variables.mdx docs-site/docs/guides/red-team-api.md docs-site/docs/guides/scan-api.md docs-site/docs/index.mdx docs-site/docs/guides/examples.mdx docs-site/sidebars.ts (passed)
Open in Web View Automation 

Co-authored-by: Calvin Remsburg <cdot65@users.noreply.github.com>
@cdot65

cdot65 commented Jul 9, 2026

Copy link
Copy Markdown
Owner

Superseded by #201. This PR had merge conflicts (stale by ~8 days; #187#200 rewrote several of the same files) and one factual error (goal_type: 'JAILBREAK' is not a valid goal type). #201 salvages the accurate content — verified against source, rebased onto current main, with the bad example corrected and the docs added since folded in. Closing in favor of #201.

@cdot65 cdot65 closed this Jul 9, 2026
cdot65 added a commit that referenced this pull request Jul 9, 2026
…201)

- scan-api/architecture: API key HMAC and/or bearer token; lowercase
  x-pan-token / x-payload-hash headers; init() requires at least one
- config/env: fill TOKEN_ENDPOINT defaults + EU regional endpoints
- architecture/vocabulary: replace fictional ListingOptions (sort/filters)
  with real per-service pagination (Mgmt offset/limit, MS/RT skip/limit/
  search, DLP page/size); document RequestSpec fields; fill domain vocab
- red-team-api: enum casing (COMPLETED/STATIC/FAILED/HIGH/API/ACTIVE),
  updatePrompt uses `prompt` not `content`, corrected goal_type (AGENT,
  not the invalid JAILBREAK from the original PR) + status filter
- index: zod validation note; MS rule instances vs read-only rules
- new Runnable Examples guide page (+ sidebar), including the
  network-broker example the original PR predated

Supersedes #185 (conflicting/stale draft); drops its one bad goal_type
example and folds in docs added since.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants